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The information contained In this document fs proprietary to 
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INTRODUCTION AND OVERVIEW 


BACKGROUND 

This Is one of several Interface Software modules developed by 
the Hardware Development Group to provide an interface between the 
Communication Software and Lacs hardware. Basically, [ft fs a 
firmware module controlling hardware functions and yet is written in 
"co" tanguage and [ts running under the control of the Kernel 
Operating System environment. , 

This Interface supports a physical !/0 Interface between the 
Level 6 and Lan controller. All ltOLOs that are destined for this 
controller are assembled and dispatched to various layers which 
require communication with Level 6. This module can be viewed as an 
extension of the Kernel Service function. 


BASIC PURPOSE | 

The basic function of the module Is to recognize the folds that 
are issued by a CPU and dispatch them to [ts destination according 
to an entry in the channel table which is previously setup by the 
user, 


BASIC STRUCTURE 

This module essentially consists of three sections.The first 
section [nitializes the IOLD queues and hardware enviroment for 
accepting !OLDs from Level 6. The second section contains the main 
routine looking for messages from its own mallbox to perform maliibox 
registration and presentation of channel maflbox [Information that 
specifles where an IOLD may be dispatched. The third section Is the 
[OLD Interrupt handler. It assembles the [Incoming !OLDs from the 10 
queues [nto messages and dispatches them to their destination 
according to their channel mailbox table entry. It also manages the 
queues for the hardware to continue to accept IOLDs from the 
megabus. 


BASIC OPERATION | 

The process starts with the [Initialization code. It programs the 
dma chip with two queue pointers and sets up the control registers 
ready for lOLDs. The queues are cleared to zero. The interrupt 
routine to handle the next IOLO queue {is registered with the 
Kernel. Now it [Is ready to accept messages from the user to register 
their mailbox entries. When an IOLD arrives the channel associated 
with It will be used to pickup the entry. It is this entry that the 
[OLD will be dispatched to. During the registration no IOLD will be 
allowed until an event registration is completed.Then the start_io 
fold information will be sent to the event mailbox. Only this time, 
a signal is given to hardware to enable megabus !0 reception. The 
operation is under the Kernel 0.S. environment. 


Ze 
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EXTERNAL SPECIFICATION 


2.1 OWNED DATA STRUCTURES 


A data structure Is created to handie !/0 orders. The "tet 
Declaration: 


struct § short ch_fe; /* channel number and function code */ 
long *16_address;/* Level 6 memory address */ 
short range; /* range */ | 
TIOITTEM 

struct § 


IOITEM fo_lfst0L32]; /* first to queue list */ 
lOITEM fo_list1032]; /* second Io queue IIst */ 
lOITEM to_lItst2L32]; /* third fo queue list */ 
[OITEM fo_list3(C32]; /* fourth fo queue list */ 


tDataDes; 

The physical layout for DataDes: 
ca al case (asa a ahs (Ss soe 800400 
q q 
q | 
q q 
Selecta ae anata ea era tia eaten 800500 
q q | 
q q 
q q 
ee ew nn eee enn eee 800600 
q | q 
q q 
q q 
i a da ah ccs as cea isos es ers eres os ana 800700 
q q 
J { 

q q 


IOLD queues struct 


A mallbox table for 64 channels and an Event is created during 
startup. This table contains all mailbox Ids. When an fold comes 
the channel associated with this fold will be used to pickup the 
mailbox [Id from the table and dispatch to that mailbox. An zero 
entry wlll dispatch to the event mailbox. A read or write command 
to the fable is permitted any time. 


—_ 
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( EXTERNAL INTERFACES 


2.5 


The 10 Dispatcher [s driven by two external events. A 
channel mallbox registration(write channel mailbox Id) or read 
channel matlbox Id Is accomplished with the 0.S. sendmsg call. The 
message type Is register normal,register event, read normal,or 
read event. The "c" Declaration for the message: 


struct chan_mbid § 


MSG m | /* kernel message header */ 
short chan_nmb /* channel number bit 10 = 15 #*/ 
MBID mbid /* matlbox Id for this channel */ 
MBID ret_mbid /* return mailbox Id */ 
short ret_code /* normal = 0,undefined type=-1*/ 
tT; 

When an event mailbox Is registered for the first time the 
start 1/0 iold being queued up by the prom firmware Is sent to the 
event mallbox and hardware [s enabled to accept any !0 oders. 
When the cpu [Issues an 10 order to Jac controller the hardware put 
It Into the queue and cause a level 4 68000 Interrupt. The 10 
Dispatcher Is activated and uses the following "“c" declaration 


to dispatch the fold: 


struct lol dmsg§ 


MSG m /* kernel message header */ 
short chanfc /* channel number and function code*/ 
/* bit 0 -9 channel# 10 - 15 = IOLD*/ 
long *I6 addr /* Icb address In Level 6 */ 
short Icb_inf /* protocal Id and Icb size */ 
13 


INITIALIZATION REQUIREMENTS 


The i[Inftializatifon and main entries are part of the system 


table,CS!1 file. When the system Is up this process is also 
ready. The maflbox [fd for this process Is "IOQDISP". The mailbox 
table is created and Is cleared to zero. !0 queues are setup and 


cleared to zero. The dma chip fs setup and is ready. However, 
Registration of the interrupt routine to handle 10 with the O.S. 
must done when the system is powered up. No !10 orders would be 
accepted until event registration Is completed first. 


TERMINATION REQURIEMENTS 


There Is no termination requirement for this IO Dispatcher as 
long as the Lacs board Is up. 


10 Dispatcher Interface Software Component Specification 


ENV [RONMENT 


The code is [n "c"™ control megabus Interface and operate under 
the environment of the Bridge Kernel. 


TIMING AND SIZE REQUIRMENTS 


The size of this module fs approxmately 2k words. 


ASSEMBLY AND LINKING 
The source code name for this fs lac_t!to.c and {[s In fhe 


directory /usr/dvlp/megabus. The binary file lac_lo.b must 
linked with the usr/dvip/kernel to create a loadable bound unit. 


TESTING CONSIDERATIONS 
None 


DOCUMENATION CONSIDERATIONS 


The source code Is _ written In Men language and is 
self-explanatory. 


2.10 OPERATING PROCEDURES 


2.11 


None | 2 


ERROR MESSAGES 
None 
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INTERNAL SPECIFICATION 


OVERVIEW 

The basic function of the 10 Dispatch fis to honor the requests 
from users to register or obtain channel mailbox Id for a given 
channel. An !OLD Interrupt handier is implemented to assemble and 
dispatch [OLDS that are placed by the hardware In the 
pre-~assigned queues. The module fs linked and run under the 
control af the Bridge Kernel. 


3.2 SUBCOMPONENT DESCRIPTION 


5.2.1 I!0 HANDLER 


This handler is hardware [Interrupt driven. Upon entry Into the 


routine it scans the hardware queue for fold. The channel number 
associated with the fold will be used as an index to the channe| 
mailbox table to obtain the mailbox Id. Then the fold will be 
dispatched to that mailbox [d. The routine resumes scan until al! 


[olds are dispatched. 


3.2.2 CHANNEL MAILBOX REGISTRATION 


A channel mailbox table {fs setup to accommodate all 64 
channels plus and event mailbox Id. A user may send a 
registration message to request to put an entry for or read a 
particular channel or event Id. When a user.registers the event 
mallbox Id with this component for the first time [It will 
dispatch the start 10 IOLD which fs placed by the prom firmware 
In specific temporary buffer to the event mallbox Id. The 
component is always ready to receive from its own malibox for 


messages. A brecelve is called. 


3.2.5 10 QUEUE REQUEST INTERRUPT HANDLER 


When the DMA chip runs out a queue [t [Interrupts for another 


one. The routine responds the request by consulting the IIst 
which will specify which one of the four queues should be 
programmed Into the chip - Before returning to the Kernel [It must 
reset the block transfer complete bit In the channel status 


register. 


3.3 FUTURE DEVELOPMENT AND MAINTENANCE 


as required 


4. 
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PROCEDURAL DESIGN 
none 


Parr. 
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INTRODUCTION AND OVERVIEW 


BACKGROUND 

This fis one of several Interface Software modules developed by 
the Hardware Cevelopment Group to provide an interface between the 
Communicaticn Software and Lacs hardware. Basically, it is a 
firmware module controlling hardware functions and yet is written jn 
"co" Language and fs running under the control of the Kernel 
Operating System environment. 

This interface supports a physical !/0 Interface between the 
Level 6 and Lan controller. All JIOLOs that are destined for this 
controller are assembled and dispatched to various layers which 
require communication with Level 6. This module can be viewed as an 
extension of the Kernel Service function. 


BASIC PURPOSE | 

The basic function of the module is to recognize: the iolds that 
are issued by a CPU and dispatch them to [ts destination according 
to an entry in the channel table which is previously setup by the 
user. 


BASIC STRUCTURE 

This module essentially consists of three sections.The first 
section initializes the IOLD queues and hardware enviroment for 
accepting !OLOs from Level 6. The second section contains the main 
routine looking for messages from its own mallbox to perform mailbox 
registration and presentation of channel mailbox Information that 
specifies where an IOLD may be dispatched. The third section [Is the 
lOLD [nterrupt handler. It assembles the [Incoming I!OLOs from the I0 
queues [nto messages and dispatches them to thefr destination 
according to thelr channel mailbox table entry. It also manages the 
queues for the hardware to continue to accept !O0LOs from the 
megabus. | 


BASIC OPERATION 

The process starts with the initialization code. It programs the 
dma chip with two queue pointers and sets up the control registers 
ready for IOLDs. The queues are cleared to zero. The interrupt 
routine to handle the next !0LD queue [Is registered with the 
Kernel. Now it is ready to accept messages from the user to register 
their mailbox entries. When an JOLD arrives the channel associated 
with it will be used to pickup the entry. If is this entry that the 
[OLD will be dispatched to. During the registration no IOLD will be 
allowed until an event registration Is completed.Then the start_io 
fold information will be sent to the event mailbox. Only this time, 
a signal is given to hardware to enable megabus !0 reception. The 
operation is under The Kernel 0O.S. environment. 


2. 
2.1 
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EXTERNAL SPECIFICATION | | -_ 


| sa 
OWNED DATA STRUCTURES 


A data structure Is 
Declaration: 


created to handie !/0 orders. The ton 


struct § short ch_fc; /* channel number and function code */ 
long *l6_address;/* Level 6 memory address */ 
short range; /* range */ : 
TIOITEM 
struct § 


IOITEM to_ltst0[32 


iF /* first lo queue IIist */ 
lOITEM fo_list1032]; 

is 

ae 


/* second Io queue list */ 
/* third to queue [Ist */ 
/* fourth fo queue iftst */ 


lO'TEM fo_ltst2032 
lO!1TEM io_list3C32 
tTOataDes; 


The physical layout for DataDes: 


_/ 
a 


\ 
J 
7 


wer rr nr nr eee eee eee 800400 

| { 

{ { 

| { 

we em mm me remem emer reer nn 800500 

{ { 

{ { 

{ { 

we eee mee meee mene ewe oornn 800600 

a i ae 

{ q 

orem ee ew ene een eerenececee 800700 

q { 

q { 

{ q 

[OLD queues struct 
A mallbox table for 64 channels and an Event is created during 

startup. This table contains all maflbox Ids. When an fold comes 
the channel associated with this fold will be used to pickup the 
mailbox id from the table and dispatch to that mailbox. An zero 

entry wlll dispatch to the event malilbox. A read or write command 

to the table [s permitted any time. 
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Zev EXTERNAL INTERPAGES 


The 10 Oispatcher is driven by two external events. A 


Channel maildox registration(write channel mailbox Id) or read 
channel mailbox id is accomp!ished with the 0.S. sendmsg call. The 
message type is register normal,register event, read normal,or 
read event. The "c" Declaration for the message: 


struct chan_mbid § 


MSG m /* kernel message header */ 
short chan_nmb ./* channel number bit 10 - 15 ¥*/ 
MBID mbtid /* matlbox Id for this channel */ 
MBIO ret_mbid /* return mailbox Id ay 
short ret _code /* normal = O,undefined type=-1*/ 
tT; 

When an event mailbox is registered for the first time the 
start 1/0 iold being queued up by the prom firmware is sent to the 
event mailbox and hardware is enabled to accept any !Q oders. 
When the cpu [Issues an 10 order to {ac controller the hardware put 
it into the queue and cause a lfevel 4 68000 interrupt. The 10 
Dispatcher is activated and uses the following "c" declaration 


to dispatch the iold: 


struct foldmsg§ 


MSG m /* kernel message header ¥/ 
short chanfc /* channel number and function csode*/ 
/* bit 0 -9 channel # 10 - 15 = IO0LD*/ 
long *16 addr /* Icb address In Level 6 ar : 
short Icb_inf  /* protocal id and Icb size ey 
Tt: 


INITIALIZATION REQUIREMENTS 

The initialization and main entries are part of the system 
table,CS! fllie. When the system [Ss up this process is also 
ready. The maflbox Id for this process Is "JOQDISP", The mailbox 
table is created and [s cleared to zero. !I10 queues are setup and 


cleared to zero. The dma chip [fs setup and is ready. However, 
Registration of the Interrupt routine to handle 10 with the 0O.S. 
must done when the system is powered up. No 10 orders would be 
accepted unti| event registration is completed first. 


TERMINATION REQURIEMENTS 


There is no termination requirement for this 10 Dispatcher as 
long as the Lacs board [s up. 
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2.5 ENVIRONMENT i 
ee 
The code is in "ce" control megabus Interface and operate under ~ 
the environment of the Bridge Kernel. 
2.6 TIMING AND SIZE REQUIRMENTS 
The sf{ze of this module Is approxmately 2k words. 
2.7 ASSEMBLY AND LINKING 
The source code name for this [Is lac_!fo.c and [Is In the 
directory /usr/dvip/megabus. The binary file lac_!o.b must 
linked with the usr/dvlp/kernel to create a loadable bound unit. 
2.8 TESTING CONSIDERATIONS 
None 
2.9 DOCUMENATION CONSIDERATIONS 
The source code Is written in. tee language and Is 
self-explanatory. 
2.10 OPERATING PROCEDURES = 


None 


2-11 ERROR MESSAGES 
None 
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ig, Ne INTERNAL SPECIFICATION 


( 3.1 OVERVIEW 
The basic function of the 10 Dispatch [s to honor the requests 


from users to register or obtain channel mailbox id for a glven 
channel. An !1OLOD interrupt handler [s imp!emented to assemble and 
dispatch (OLDS that are placed by the hardware in the 
pre-assigned queues. The module is lInked and run under the 


control of the Bridge Kernel. 
3.2 SUBCOMPONENT DESCRIPTION 


Se26) 10 HANOLER 
This handler is hardware interrupt driven. Upon entry [Into the 


routine it scans the hardware queue for jiold. The channel number 
associated with the fiold will be used as an index to The channel 
mailbox table to obtain the mailbox [d. Then the fold will be 
dispatched to that maflbox Id. The routine resumes scan untl! al! 


iolds are dispatcned. 


3.2.2 CHANNEL MAILBOX REGISTRATION 


A channel mailbox table [s setup fO accommodate all 64 

channels plus and event mailbox Id. A user may send a 
registration message to request to put an entry for or read a 
particular channel or event Id. When a user registers the event 
maflbox id with this component for the first time [It will 
dispatch the start 10 IOLD which fs placed by the prom firmware 

_ in specific temporary buffer to the event mallbox id. The 
( : component Is always ready to receive from its own mailbox for 


messages. A brecelve is called. 


3.2.5 10 QUEUE REQUEST INTERRUPT HANDLER | 
When the OMA chip runs out a queue [tft interrupts for another 


one. The routine responds the request by consulting the list 
which will specify which one of the four queues should be 
programmed Into the chip . Before returning to the Kernel it must 
reset the block- transfer complete bit in the channel! status 


register. 


3.3 FUTURE DEVELOPMENT AND MAINTENANCE 
as required 
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4. PROCEDURAL DESIGN 
none 


